<html>
  <body>

<h2>GeoTools 2.5.4</h2>

<p>
Thank you for downloading GeoTools 2.5.4. This release was created on: March 16, 2009
</p>
<p>
This release contains only a subset of the current GeoTools codebase.
The full GeoTools codebase is made up of over 30 modules; 
Only the modules which are considered to be stable will be included in this
release.
</p>
<p>
For this release the following modules comprise the geotools library:<br>
<pre>
api
coverage
cql
data
jdbc
legacy
main
metadata
pom.xml
referencing
render
sample-data
xml
</pre>
</p>
<p>
The following modules plug-ins that add functionality to the geotools library:<br>
<pre>
<rcsde
db2
epsg-access
epsg-extension
epsg-hsql
epsg-postgresql
epsg-wkt
geotiff
gtopo30
image
imageio-ext-gdal
imagemosaic
imagemosaic-jdbc
imagepyramid
postgis
property
referencing3D
shapefile
wfs
wms
/pre>
These optional jars typically provide support for specific data formats or
sources, or provide specific additional functionality.
</p>
<p>
The following modules are extensions that build interesting functionality ontop of the geotools library:
<pre>
brewer
graph
openoffice
shapefile-renderer
validation
widgets-swing
xsd
</pre>

</p>
<p>
The following modules are unsupported experiments made available for early feedback and testing:
<pre>
directory
ogc
gml
mif
</pre>
</p>

<p>
For more information, and documentation on the geotools library please see
our <a href="http://docs.codehaus.org/display/GEOTOOLS">Community Wiki</a> or the <a href="http://docs.codehaus.org/display/GEOTDOC">User Guide</a>.
</p>
The following demos are also available as part of our documentation:

<pre>
coverage-use
example
introduction
libraryJTS
mappane-use
referencing
svgsupport
xml-po
</pre>
</p>
<p>
You can find out more about each of the major modules by going to:<br>
<ul>
  <li><a href="http://maven.geotools.fr/reports/">http://maven.geotools.fr/reports/</a>
  <li><a href="http://javadoc.geotools.fr/">http://javadoc.geotools.fr</a>
</ul>
</p>

<h3>NOTE</h3>
<p>
The details contained in the rest of this file are provided as a quick start
reference. For full details on requirements and build process please see
the <a href="http://docs.codehaus.org/display/GEOT/Home">Developers' Guide</a>.
</p>

<h3>REQUIREMENTS</h3>
<p>
To use the geotools libraries you will need:
<ul>
<li>Java 5 or higher.
<li>The Java Advanced Imaging Libraries (JAI)
<li>The Java Advanced Imaging Image I/O Tools
</ul>

</p>
<p>
The JAI and the JAI I/O Tools are standard extensions to Java created by SUN.  
They have versions specific to different platforms so we cannot distribute them
as part of the release.
</p>

<p>
You can obtain the latest versions of both of these <a href="http://java.sun.com/products/java-media/jai/current.html">here</a>. Detailed instructions can be found <a href="http://docs.codehaus.org/display/GEOTOOLS/Dependencies">here</a>.
</p>

<h3>ORACLE REQUIREMENTS</h3>
<p>
In order to use the Oracle module, you need the Oracle JDBC driver
from Oracle. Unlike most external libraries used in GeoTools, we
cannot redistribute this jar.

</p>
<p>
However, you can obtain them from the Oracle website, free of charge,
after registering:
- http://otn.oracle.com/software/tech/java/sqlj_jdbc/content.html
  
Please see the developers guide for more information.
</p>

<h3>BUILDING</h3>
<p>
In order to build GeoTools you will need a copy of <a href="http://maven.apache.org/download.html">Maven 2</a>.  Maven is a project management tool from the Apache group.  
</p>
<p>
At the time of writing, the build process was known to work with the Maven 2.0.8 release.
</p>
<p>
Once you have maven installed, you can perform a full build by moving to the geotools folder and typing:

<pre>
mvn install
</pre>
</p>

<p>
Please read the <a href="http://docs.codehaus.org/display/GEOT/2.5+Using+Maven">Developers Guide</a> for more information about maven:
</p>

<h3>GETTING INVOLVED</h3>

<p>
If you are interested in the future development of GeoTools then feel free to
join the geotools-devel mailing list and join in the weekly IRC sessions.

</p>
<p>
We welcome contributions of new modules as well as keen developers who want to
work on the project as a whole.
</p>
<p>
For more general queries, the <a href="mailto:geotools-gt2-users@lists.sourceforge.net">gt2-users mailing list</a> is available.
</p>
<p>
You can find out more about the mailing lists and recent news by going to the <a href="http://geotools.org">GeoTools Homepage</a> and by reading the <a href="http://docs.codehaus.org/display/GEOTOOLS/Home">GeoTools Guide</a>.

<p>
<p>
Good luck and many thanks for your interest in GeoTools,
</p>
<p>
<i>The GeoTools Project Management Committee, Open Source Geospatial Foundation</i>
</p>
  </body>
</html>

